home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 240 (1993-03-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 240 (1993-03-10)(Manewaldt, A.)(DE)(PD).adf / DisKey2.1 / DisKey.doc < prev    next >
Text File  |  1993-02-27  |  33KB  |  1,014 lines
  1. DisKey 2.1 - preliminary documenation
  2.  
  3.  
  4. 1.1 Legalese
  5.  
  6. This entire document is (c) 1991 by Thomas Baetzler. You are granted the
  7. non-exclusive right to print one (1) copy of this text for your personal
  8. use. You may copy this file only as part of the DisKey distribution, under
  9. the rules that the author of DisKey, Angela Schmidt, imposes.
  10.  
  11. The author of this manual does not guarantee for the correctness of
  12. informations contained in this manual. While much time has been spent on
  13. proof reading, I would just be surprised if there wasn't some kind of
  14. mistake somewhere.
  15.  
  16. The author also disclaims any liability which could arise from improper use
  17. of DisKey. Whatever you do with DisKey is just your own risk.
  18.  
  19. If you think this is paraniod: This is just to protect my rights. While I
  20. expect to gain nothing for all my troubles, except maybe an ARexx port in 
  21. one of the next releases of DisKey, this is my insurance against anybody 
  22. who wants to make money with this by reprinting it as instruction set in a 
  23. computer magazine. This happened to Angela Schmidt with the German 
  24. instructions to DisKey 1.2, which were reprinted without permission in the
  25. magazine "Amiga Praxis".
  26.  
  27. If you want to contact me, please feel free to do so:
  28.  
  29.  Thomas Baetzler       2:247/7501.5 (Fidonet)
  30.  Schlossbergstr. 4     tom@armchair.ka.sub.org (UUCP, est. Jun-91)
  31.  7570 Baden-Baden
  32.  
  33. While I do not charge you for reading this, it would be nice to hear from
  34. you: Comments on style and language are always welcome, as much as
  35. postcards from your hometown, or a book or magazines you don't need any 
  36. longer. Especially printed matter is really appreciated, since you have to 
  37. pay 2 to 5 times of the cover value, if you manage to get anything at all.
  38.  
  39.  
  40. 1.2 Notes on DisKey
  41.  
  42. Version 2.1 of DisKey is Shareware. If you're unfamiliar with this concept:
  43. You may use this program free of charge to try it out, whether it fills
  44. your needs or not. If after a sufficient long trial period you find that
  45. you want to continue use DisKey, please be so fair and pay up your debt to
  46. Angela. Your support will ensure that Angela continues to improve this
  47. project. Authors of Shareware products who wish to use DisKey could
  48. alternatively send Angela a registrated copy of their product, in turn they
  49. will receive their registrated copy of DisKey.
  50.  
  51. As an alternative to the Shareware DisKey, there's DisKey professional: It
  52. offers all of the functionality of the original DisKey, and additionally
  53. it supports access to all sector oriented exec-devices like your hard disk,
  54. the recoverable ramdisk RAD:, and many more. DisKey professional comes even
  55. with two new devices/handlers, which will let you edit files and the RAm
  56. part of your computer's memory.
  57.  
  58.  
  59. 1.2.1 What is DisKey?
  60.  
  61. DisKey is a sector oriented disk monitor. The stress on 'sector' implies
  62. that it wasn't written to patch files, but to make changes to a disk's
  63. structure. The name implies the history: Angela wrote DisKey, because she
  64. had time and time again problems with errors on her disks, and the
  65. disk validator only referred to the condition of key so-and-so. 
  66.  
  67. As the disk doctor proved quite unreliable, and disksalv (Thanks, Dave!)
  68. was still in the making, Angela decided to tackle the problem herself:
  69. First of all she needed a tool to examine and change the structures on
  70. disk. This is how DisKey was born.
  71.  
  72.  
  73. 2.0 Getting to know DisKey
  74.  
  75. It may well take you a long time to tackle all the features in DisKey: Just
  76. like with a Transformer (tm), there's 'more than meets the eye'. However,
  77. there's no need to know everything, it just makes life a bit easier, if
  78. you're using DisKey all the time.
  79.  
  80.  
  81. 2.1 The Layout
  82.  
  83. After starting DisKey, you will see the Main screen: On top is the menu
  84. bar. Just below, there is the hexadecimal display area, in which the
  85. currently loaded sector is displayed as hexadecimal numbers. Every four
  86. bytes are grouped together as a longword, so that we end up with eight
  87. columns of 16 longwords. Order is from left to right, and then down, so
  88. that the leftmost two digits of the first line of the first column are the
  89. first byte of the current sector, while the byte just below ist the 33th.
  90. byte.
  91. Below the hexadecimal display, there is the Iconify-Gadget to the left,
  92. while the rest of that line is devoted to the information exchange. Per
  93. default this small window displays some calculations based on your current
  94. cursor position in the hex display.
  95. If the dis.library is installed in libs:, you can switch the display mode
  96. to disassembly and back by clicking once in this line.
  97. Below that, there's three boxes: The left- and rightmost form the ASCII
  98. display of the current sector. You should imagine the leftmost box as
  99. sitting on top of the rightmost box, so that you get 16 lines of 16
  100. characters. This display maps a byte value to the corrresponging character
  101. of the active font, so that it also displays 'unprintable' characters,
  102. unlike the AmigaDOS 'Type' command in 'HEX' mode.
  103. In between these, there's the command selection box. The general idea
  104. behind this is to provide a versatile user interface: You can invoke most 
  105. commands with either shortcuts bound to the left or right Amiga key, or
  106. select them from the menu, or select them by clicking the appropriate line
  107. in the command selection box.
  108. The command selection box has three menus to display: Hitting the right
  109. mouse button while the cursor is not in the top row of the screen will
  110. switch to the next menu.
  111. Below the left ASCII-display box, there's two boxes for sector selection.
  112. Each value can be modified by clicking on the '+' and '-', or by clicking
  113. on the numbers, and entering a value manually. But pay attention: While one
  114. of those input fields is active, DisKey accepts no other commands. Be sure
  115. to leave an input field by hitting Return!
  116. And this leaves just one thing for description: The message box. In this
  117. Area, DisKey displays any kind of information it thinks you'd like to know,
  118. like type of the current sector, or return code from the last action.
  119. If you can't understand what DisKey is telling you, check whether the Menu
  120. Language is set to English: Find the menu DisKey.prefs, and select
  121. "Sprache", subitem "English".
  122.  
  123.  
  124. 2.2 Editing a sector
  125.  
  126. As you have noticed, DisKey displays the current sector in two ways: As hex
  127. digits, and as ASCII characters. You can change the contents of the sector
  128. from both displays, although only one of them is active at any given
  129. moment: You can tell by the color of the border. If it doesn't match the
  130. colors of the other boxes on the screen, it's activated. You can switch the
  131. active display by clicking into the deactivated display: DisKey will then
  132. place the cursor of the display under the mouse pointer.
  133.  
  134.  (Well, it isn't really a mouse, it's rather your cute pink-ish 'Nessie'
  135.   pointer, which reminds you that DisKey is active at the moment, and that
  136.   everything you type is going to be sent to DisKey for evalution. It's
  137.   rather useful if DisKey runs in it's own screen, and you've just switched
  138.   screens to another application: A perfectly harmless shortcut in your
  139.   application might be misinterpreted by DisKey. The best case is when you
  140.   just realize that things don't work the way they're supposed to.)
  141.  
  142. The hex display accepts only hexadecimal numbers as input, which must be
  143. composed of the digits 0..9 and the characters a..f. Each number consists
  144. of two digits. Both are highlighted when the cursor is moved on them.
  145. Entering the first digit will change the high nibble of the number you're 
  146. currently editing. If you only want to cahnge this, you could then use the 
  147. cursor keys to move to the next number you want to change. If you only want
  148. to change the low nibble, you still have to copy the high nibble.
  149.  
  150. In the ASCII display, you can enter any character you like: Even dead keys
  151. are supported, so that you can enter things like 'à' as a combination of
  152. '`' and 'a'.
  153.  
  154. The cursor keys work as one might expect: Left and right move you to the
  155. preceding or following byte of data. When you are at the beginning or the
  156. end of a sector, moving beyond that border will place you at the end or the
  157. beginning, respectively. Moving up and down will scroll you through the
  158. columns of data, without necessarily jumping to the logically next or
  159. previous byte.
  160.  
  161. When used in conjunction with the Control key, the cursor keys will act
  162. differently: CTRL-up will set the cursor at the beginning of the sector,
  163. and CTRL-down will set it at the end. CTRL-Left and right will place it at
  164. the beginning or the end of the current line.
  165.  
  166. The ALT key adds an Undo-feature: While moving into an sector with any
  167. combination of ALT and the cursor keys, the former contents will be
  168. restored. You can tell when a value is modified by it's color: It then
  169. matches the color of the box borders.
  170.  
  171. When you write a sector back successfully, the changed bytes are displayed
  172. in the background color. You can undo these aswell, until you write the
  173. sector again, or read in a new sector.
  174.  
  175.  
  176. 2.3 The integrated disassembler
  177.  
  178. To use this feature, you need to have the dis.library in the libs: drawer
  179. of your workbench disk. You activate the disassembler by clicking into the
  180. information exchange window. It will then display the value of the word
  181. below the cursor interpreted as MC 680x0 mnemonic. Sadly, there's no
  182. assembler included, so you can't enter mnemonics directly. As there is no
  183. secure method to estimate where a 680x0 instruction begins, the DisKey
  184. disassembler tries not to be smart about this. If you're sure that you've
  185. one instruction right, SHIFT-ALT-right will move the cursor to the
  186. beginning of the next instruction. In the reverse direction you might
  187. encounter some problems.
  188.  
  189.  
  190. 2.4 The safety catch
  191.  
  192. In the standard configuration, DisKeey is set up so that it will not do
  193. potentially dangerous things without first checking back with the user.
  194. Selecting an option like 'Write block' or 'Format kwik' will usually bring
  195. forth an requester asking you whether you want to go ahead or not. If you
  196. select 'OK', you're on your own.
  197. A way to override this is to hold down either mouse button or hotkeys:
  198. After some seconds, DisKey decides you're sure of what you're doing, and
  199. goes ahead without further prompting.
  200. But there are people among us who think that they know what they're doing:
  201. If you don't feel like having a stupid application waring you of possible
  202. dangers, you might aswell deselect the "safety catch" in "DisKey.prefs".
  203. This disables all fail-safes and turns DisKey in the "You wanted it, now
  204. you've got it' kind of disk monitor. This might please the masochistic Un*x
  205. user who just loves the feeling of katharsis when just another valuable
  206. data disk goies down the drain, but for the average user, I recommend to
  207. keep the safety catch on.
  208. I even recommend the additional safety of only letting DisKey loose on
  209. backup copies of valuable disks: While fixing a mashed root block with
  210. DisKey is certainly faster than running DiskSalv when you know what you're 
  211. doing, you're asking for trouble if you're doing this on the master disk.
  212. Make a mistake, and nobody can tell whether DiskSaly will be able to fix
  213. the additional damage you might have caused.
  214.  
  215.  
  216. 2.5 Virus check
  217.  
  218. Whenever you change a disk in the currently active drive, DisKey checks the
  219. disk's bootblock for viri and other abnormalities. If it detects anything
  220. out of the normal, it will display the bootblock instead of the rootblock,
  221. and print out a warning message in the status display. Currently, DisKey
  222. knows the following viri:
  223.  
  224. Byte Bandit Plus VIRUS
  225. Byte Bandit VIRUS
  226. Warhawk VIRUS
  227. Bamiga Sector one VIRUS
  228. Micro Master Virus
  229. LSD VIRUS
  230. SCA-VIRUS
  231. SCA-Mutation
  232. DASA (Byte Warrior) VIRUS
  233. Paramount VIRUS
  234. Byte Warrior Mutation
  235. North Star II VIRUS
  236. System Z VIRUS V3.0
  237. System Z VIRUS V4.0
  238. System Z VIRUS V5.0
  239. System Z VIRUS V5.4 (PVL-VIRUS)
  240. GADAFFI VIRUS
  241. North Star I VIRUS
  242. DiskDoctors VIRUS
  243. Revenge VIRUS 1.2
  244. Pentagon VIRUS
  245. Time Bomb VIRUS 1.0
  246. Lamer-Exterminator VIRUS
  247. GYROS-VIRUS
  248. Obelisk-VIRUS
  249. VKill V1.0 VIRUS
  250. WAFT-VIRUS
  251. MCA (Class Abraham) VIRUS
  252. H.C.S VIRUS
  253. Butonic VIRUS
  254.  
  255. The virus check is really simple, since DisKey has to work without a large
  256. brain file. While the virus check is far from fool proof, it is still quite
  257. useful, especially if you're working with someone else's disks.
  258. As the test only checks two or there longwords of the code, it might aswell
  259. happen that a completely inncocent bootblock gets out signed as dangerous.
  260. If you're in doubt, please use a dedicated virus checker like ZeroVirus to
  261. verify the warning.
  262. However, it is quite smart about the Lamer Exterminator, since it reads the
  263. bootblock twice: First try is with normal TD_READ. The lamer exterminator
  264. patches this call to put up a standard bootblock instead of his own code.
  265. So you can have a second try by having "Raw Read" selected in
  266. "DisKey.prefs": DisKey then re-reads the bootblock using TD_RAWREAD, and if
  267. the result differs from the first try, your system is propably currently
  268. infected by a lamer exterminator virus, and you'll be notified of this
  269. condition. Sadly, RAWREAD has a bug in some older revisions of the OS: You
  270. might continously get the warning 'TD_READ<>RAWREAD' without having an
  271. infected system. In this case, the safe check fails for you. Sorry, pal.
  272.  
  273. Since there is a fairly large number of custom bootblocks around, DisKey
  274. also checks for these. They are not displayed as nonstandard boot code.
  275.  
  276. Observe Bootblock
  277. Neuhaus Bootblock
  278. Sigma Virusterminator Bootblock
  279. AVIREX-Bootblock
  280. CCS-Bootblock
  281. Chip-Bootblock
  282. Blizzard Protector
  283. MEMCTRL-Bootblock
  284. Starfire2-Bootblock
  285. Bootcopy-Bootblock
  286. XCopy Bootblock
  287. Tristar Viruskiller V1.1
  288. Viruskiller Professionel V2.0
  289.  
  290. Aside from this, there's a number of bootblocks of which DisKey doesn't know
  291. whether they're dangerous or not. In the meantime, you'll be notified of
  292. their presence just as they were viri:
  293.  
  294. ASS VIRUS Bootblock
  295. Virus Destructor Bootblock
  296. SQC Bootblock
  297. Hotline Bootblock
  298. Overscan Bootblock
  299. MGF Bootblock
  300. Memory_I Bootblock
  301. Memory_II Bootblock
  302. Pentagon Bootblock-Loader
  303. Phaselock Bootblock
  304. Playfield Bootblock
  305. Protected Bootblock
  306. StealMem Bootblock
  307. Virus Alert I Bootblock
  308. Virus Alert II Bootblock
  309. PVL Protector
  310.  
  311.  
  312. 2.6 The status window
  313.  
  314. DisKey tries always to provide you with all the information it can get.
  315. Under certain circumstances, and especially with the Fast Filesystem, this
  316. is not always possible. As a default, you'll see '????' if DisKey isn't
  317. sure.
  318.  
  319. Disk types:
  320.  
  321.  - DOS  : Old Filing System
  322.  
  323.  - FFS  : Fast Filing System
  324.  
  325.  - KICK : A1000 Kickstart Disk
  326.  
  327. Block status:
  328.  
  329.  - USED \
  330.           Depending on BAM
  331.  - FREE /
  332.  
  333.  - KICK : There's no BAM on a Kickstart disk.
  334.  
  335. Block type:
  336.  
  337. - ROOT      : Rootblock
  338.  
  339. - BOOT      : Bootblock
  340.  
  341. - BAM       : Block Allocation Map 
  342.  
  343. - BEXT      : Extended Block Allocation Table. FFS only.
  344.  
  345. - DATA      : Data block. OFS only.
  346.  
  347. - HEADER    : File Header Block
  348.  
  349. - DIR       : User Directory Block
  350.  
  351. - FILE-LIST : File-List-Block
  352.  
  353. - KICK      : Same as above.
  354.  
  355.  
  356. 2.7 The sector selection box
  357.  
  358. - DRV  : Corresponds to the entries in the menu 'DEVICE'. 0 is the first
  359.          device in that list, usually DF0:.
  360.  
  361. - BLK  : Absolute sector number, measured in offset to the first block on
  362.          the media.
  363.  
  364. - TRK  : Absolute track number. Don't confuse this with:
  365.  
  366. - CYL  : Cylinder number. Depending on the type of media, a cylinder has
  367.          one or more tracks. With 3 1/2" disks, each cylinder has two
  368.          tracks.
  369.  
  370. - SEC  : Physical sector number on track.
  371.  
  372. - HEAD : Number of head.
  373.  
  374. As mentioned above, you can enter any value you like after clicking on the
  375. name of the value, not on the value itself. Each of the gadgets can be put
  376. in decimal or hexadecimal mode: If you want to enter a hexadecimal value,
  377. precede your entry by typing a '$'. The value will then be displayed in the
  378. color of the borders. To switch to decimal notation, enter a '!'.
  379.  
  380.  
  381. 3.0 Operating DisKey
  382.  
  383. This section will provide you with a quick overview of the different
  384. functions of DisKey. Please note that DisKey distinguishes between left
  385. and right Amiga keys! So the shortcut description 'LAmiga-N' spells out as
  386. 'Press the Key n while also pressing the Left Amiga qualifier key'.
  387.  
  388.  
  389. 3.1 The Project menu
  390.  
  391.  
  392. 3.1.1 Read Block 
  393.  
  394. <R-Amiga>-l
  395.  
  396. Reads the sector specified in the sector selection boxes. The difference
  397. between BLK and SEC there is that BLK is the absolute sector number
  398. measuread as a offset to the first sector on that device, while SEC is the
  399. number of the sector on the currently active track. As the new block is
  400. always read in whenever you cahnge the settings in the selection box,
  401. you'll propably only need this to re-read a sector.
  402.  
  403.  
  404. 3.1.2 Write Block
  405.  
  406. <L-Amiga>-w
  407.  
  408. Writes the current sector back to disk. If the action was completed
  409. successfully, DisKey will change the color of the highlighted changes to
  410. the sector. Until you read or write a block again, you can still undo these
  411. changes.
  412.  
  413.  
  414. 3.1.3 Print Block
  415.  
  416. <R-Amiga>-d
  417.  
  418. Prints the selected block like 'TYPE HEX' would print a file. You can
  419. specify a redirection file by selecting 'Printer Output' in 'DisKey.prefs'.
  420.  
  421.  
  422. 3.1.4 Open Capture
  423.  
  424. <L-Amiga>-a
  425.  
  426. Opens a capture file on the RAM:disk or any other path you choose to
  427. specify in 'DisKey.prefs'. To generate unique filenames for multiple
  428. writes, DisKey appends a number to the name you specified. The capture is
  429. quite useful for salvaging data from damaged disks.
  430.  
  431.  
  432. 3.1.5 Close Capture
  433.  
  434. <L-Amiga>-z
  435.  
  436. Closes the capture file. This happens automagically (Hi, Bill Hawes B^)
  437. whenever you open a new capture, or when you leave DisKey.
  438.  
  439.  
  440. 3.1.6 Whole blk -> Cap
  441.  
  442. <L-Amiga>-y
  443.  
  444. Writes the complete current sector to the currently opened capture file.
  445. Especially useful for bootblocks and the like, where every byte counts.
  446.  
  447.  
  448. 3.1.7 Data only -> Cap
  449.  
  450. <L-Amiga>-x
  451.  
  452. If the current sector was identified as data block, the data contained in
  453. that block minus any filing-system information is written to the capture.
  454.  
  455.  
  456. 3.1.8 Salvage -> Cap
  457.  
  458. Writes the current OFS data block and all subsequently connected sectors to
  459. the capture. If selected in an fileheader block, DisKey will try to salvage
  460. each block to a capture file: If errors occur during this operation, the
  461. fragments will be put in several capture files.
  462.  
  463.  
  464. 3.1.9 Cap -> Whole blk
  465.  
  466. <L-Amiga>-Y
  467.  
  468. Inserts the contents of a file in the sector editor. Use 'write block' to
  469. write the changed sector back to disk. Specify 1 as offset.
  470.  
  471.  
  472. 3.1.10 Cap -> Data only
  473.  
  474. <L-Amiga>-X
  475.  
  476. Depending on FFS or OFS, 512 or 488 bytes are copied to the sector editor.
  477. In OFS data blocks, existing pointers will not be changed.
  478.  
  479.  
  480. 3.1.11 About DisKey
  481.  
  482. <R-Amiga>-I
  483.  
  484. This will display some information on the disk and the version of DisKey 
  485. you're currently using.
  486.  
  487.  
  488. 3.1.12 Get Info on block
  489.  
  490. <R-Amiga>-i
  491.  
  492. Interprets the longword in the hex display below the cursor as sector
  493. offset. If it is a valid sector number, information on this sector will be
  494. displayed. If selected from the menu, it will subsequentially let you
  495. select a longword which should be interpreted as pointer.
  496.  
  497.  
  498. 3.1.13 Quit DisKey
  499.  
  500. <R-Amiga>-e
  501.  
  502. Leaves DisKey, closes open capture files, and frees any inhibited drive.
  503.  
  504.  
  505. 3.2 The Block Sel menu
  506.  
  507.  
  508. 3.2.1 Jump to Block
  509.  
  510. <CTRL><L-Amiga>-s
  511.  
  512. Reads the sector which is specified by the longword that is just below the
  513. cursor in the hex display. Same rules as with 'Block info' [3.1.12]
  514.  
  515.  
  516. 3.2.2 Read Rootblock
  517.  
  518. <CTRL><L-Amiga>-r
  519.  
  520. Reads the root block of the currently active device.
  521.  
  522.  
  523. 3.2.3 Read Bootblock
  524.  
  525. <CTRL><L-Amiga>-b
  526.  
  527. Reads the boot block of the currently active device.
  528.  
  529.  
  530. 3.2.4 Read BAM
  531.  
  532. <CTRL><L-Amiga>-a
  533.  
  534. Reads the bitmap block of the currently active device.
  535.  
  536.  
  537. 3.2.5 Read Next Block
  538.  
  539. <CTRL><L-Amiga>-f
  540.  
  541. Reads starting from an Fileheader the next sector. In OFS, this can also be
  542. used to jump from one block to the next, since they are linked. In FFS,
  543. this is just now not possible.
  544.  
  545.  
  546. 3.2.6 Read Previous Block
  547.  
  548. <CTRL><L-Amiga>-v
  549.  
  550. Only with OFS: Jumps to the previous block. Since this depends on the
  551. fileheader, he has to be present for this feature to work.
  552.  
  553.  
  554. 3.2.7 Read List Block
  555.  
  556. <CTRL><L-Amiga>-l
  557.  
  558. Jumps starting from a fileheader to the subsequent list blocks, if there
  559. are any.
  560.  
  561. 3.2.8 Header Block
  562.  
  563. <CTRL><L-Amiga>-h
  564.  
  565. Jumps back to the fileheader, if you're currently in a list or data block:
  566. under FFS, this works only in list blocks.
  567.  
  568.  
  569. 3.2.9 Parent-Block
  570.  
  571. <CTRL><L-Amiga>-p
  572.  
  573. Jumps up one level in the directory hierarchy of the disk: In fileheader
  574. blocks, this will read in the directory block, and in directory blocks it
  575. will read the parent directory, or the root block, depending on your
  576. position in the hierarchy.
  577.  
  578.  
  579. 3.2.10 Undo Read/Jump
  580.  
  581. Will jump back to the block you've read in before you executed the
  582. jump/read.
  583.  
  584.  
  585. 3.3 The Extras Menu
  586.  
  587.  
  588. 3.3.1 Memorize Block
  589.  
  590. <R-Amiga>-m
  591.  
  592. Copies the current sector to an internal buffer for subsequent use.
  593.  
  594.  
  595. 3.3.2 Recall Block
  596.  
  597. <R-Amiga>-h
  598.  
  599. Recalls a previously memorized block, and writes it to the edit window. Use
  600. memorize and Recall to copy sectors!
  601.  
  602.  
  603. 3.3.3 Calc Checksums
  604.  
  605. <R-Amiga>-s
  606.  
  607. DisKey calculates the checksum for the current sector, depending on it's
  608. type. In block 512 of a kickstart disk, this will calculate a KickChecksum.
  609.  
  610.  
  611. 3.3.4 Search for
  612.  
  613. <R-Amiga>-S
  614.  
  615. Opens a search window, where you can specify what you want to search. To
  616. continue a search, just click longer on the item in the select box, or keep 
  617. <R-Amiga>-S depressed, like you were overriding the safety catch. Clicking
  618. into the search window will abandon a search in progress.
  619. The search supports also some special condition code, which must be entered
  620. in ASCII search mode in the following order:
  621.  
  622. \ObjectType\Specification\Object
  623.  
  624. where ObjectType can be:
  625.  
  626. - Header: Search for file- or directory headers.
  627.  
  628. - Parent: Search for corresponding file- or directory blocks.
  629.  
  630. - Data:   Search for data blocks only. OFS only.
  631.  
  632. - List:   Search for list blocks only.
  633.  
  634. and Specification either
  635.  
  636. - Name:   The object is a file- or directory name.
  637.  
  638. - Key:    The object is entered as a hexadecimal sector offset.
  639.  
  640. Examples
  641.  
  642.      \parent\name\DisKey  ... searches for all files that are connected to
  643.                               a directory called 'DisKey'.
  644.      \parent\key\370      ... searches all files and directories just below
  645.                               the root level of the directory hierarchy.
  646.                               ($370=880; root block on disks)
  647.      \header\name\DMouse  ... searches for all fileheaders of files that
  648.                               are named 'DMouse'.
  649.      \header              ... searches for all headers.
  650.  
  651.  
  652. 3.3.5 Format
  653.  
  654. <R-Amiga>-f
  655.  
  656. Opens the Format window, where you can specifiy a start and an end track.
  657. The sectors on the tracks to be formatted will be filled with #$00. Due to
  658. the limitations of DOS, DisKey can not check whether the format was
  659. successul. This is the reason for 'CheckDisk'.
  660.  
  661.  
  662. 3.3.6 Reformat
  663.  
  664. <R-Amiga>-r
  665.  
  666. Opens the Reformat window, where you can select the number of trials, and
  667. starting and end track. Reformat first tries to read a track. After that,
  668. the track is formatted and written back to the disk.
  669. If an error occurs while reading, DisKey tries to use Rawread to read each
  670. sector by itself.
  671. Due to the limitations of DOS (*), a Reformat may fail totally, so that you
  672. should only do it on backups of your corrupted disks.
  673.  
  674. (*) A track might look perfectly normal and readable. And yet there is the
  675. chance that a media failure lurks somewhere in the gap between last an
  676. first sector of the track. This means that DOS can successfully read a
  677. track, but on writing back, the chance is high that the data is written
  678. over the bad zone, which results in an error. Copying your disks with
  679. TurboBackup (c) Martin Kopp & Steffen Stempel insures you effectively
  680. against this risk, since it also checks the gaps when copying a disk.
  681.  
  682.  
  683. 3.3.7 Disassembler
  684.  
  685. <L-Amiga>-w
  686.  
  687. Opens the disassembler window. The whole contents of the current sector are
  688. displayed as MC 680x0 mnemonics. Using the items of the menu "Defaults",
  689. you can change the format of the listing. As long as the full-block 
  690. disassembler is running, you may not issue commands to DisKey. This needs
  691. both the Req.Library and the Dis.library.
  692.  
  693.  
  694. 3.3.8
  695.  
  696. <L-Amiga>-F
  697.  
  698. Fills the current sector in the edit screen with a byte or a pattern ofyour
  699. choice.
  700.  
  701.  
  702. 3.3.9 Fileheader
  703.  
  704. <L-Amiga>-f
  705.  
  706. Lets you enter a filename of the fileheader to which you want to jump.
  707.  
  708.  
  709. 3.3.10 Format Quick
  710.  
  711. <L-Amiga>-i
  712.  
  713. Writes new Root-, Boot- and Bitmap blocks to the currently active disk,
  714. effectively ereasing the data contained therein. Corresponds to the 'Format
  715. Quick' command of AmigaDOS. With this option you can install previously
  716. formatted disks.
  717.  
  718.  
  719. 3.3.11 Checkdisk
  720.  
  721. <L-Amiga>-p
  722.  
  723. Checks disks for errors. You may specify start- and endtracks to limit the
  724. search.
  725.  
  726.  
  727. 3.3.12 Mark as Free
  728.  
  729. <L-Amiga>-j
  730.  
  731. Marks the current sector as 'Free' in the BAM: This means he can be
  732. overwritten and deleted by DOS.
  733.  
  734.  
  735. 3.3.13 Mark as Used
  736.  
  737. <L-Amiga>-u
  738.  
  739. This marks the current block as 'Used' in the BAM; it will not be
  740. overwritten by DOS. But pay attention: Whenever DOS validates this disk,
  741. all blocks marked as 'used' which do not belong to a file will be freed
  742. again.
  743.  
  744.  
  745. 3.4 The Devices menu
  746.  
  747. This lets you select on which device you want to work. The shareware
  748. version shows you a list of possible devices, but lets you only work with
  749. the disk drives. Selecting a harddisk will effectively call up an requestor
  750. which tells you that this is only possible if you use DisKey professional.
  751.  
  752.  
  753. 3.5 The About menu
  754.  
  755. You figure it out yourself. The information contained below "Translated By"
  756. is no longer correct, since I've left the University of Karlsruhe in the
  757. meantime. The bitnet- and Internet adresses are therefore no longer valid.
  758. My fidonet number has also changed: It's now 2:241/7501.5.
  759. If luck is with me, you can get me in a few weeks' time (about Jun-91) as
  760. tom@armchair.ka.sub.org on UUCP. The physical address hasn't changed.
  761.  
  762. Send Disk-Change
  763.  
  764. (Kein Shortcut)
  765.  
  766. Sendet ein Diskchange an das gerade aktive Device.
  767.  
  768.  
  769. 3.6 The DisKey.prefs menu
  770.  
  771. This lets you change some of the defaults of DisKey. The different options
  772. will be discussed in 4.1.n.
  773.  
  774.  
  775. 3.7 The Tools menu
  776.  
  777.  
  778. 3.7.1 New Devicelist
  779.  
  780. This creates a new internal devicelist for DisKey. Useful if you have first
  781. started DisKey, and then mounted a new device. Using this function will
  782. make the newly mounted device accessible to DisKey.
  783.  
  784.  
  785. 3.7.2 Send Diskchange
  786.  
  787. Sends a diskchange to the currently used device. Necessary for some changes
  788. to take place.
  789.  
  790.  
  791. 3.8 Additional shortcuts
  792.  
  793. In addition to the sector selector, DisKey offers also another method to
  794. cahnge the current sector: The combination <R-Shift>-<L-Amiga>-b will load
  795. the next physical block, while <L-Shift>-<L-Amiga>-b will load the previous
  796. physical block. <L-Amiga>-b will act just as if you had clicked on the 'BLK'
  797. gadget.
  798. It works just the same for tracks ...-t, drives ...-d, heads ...-h, sectors
  799. ...-s and cylinders ...-c.
  800. Be sure to press the qualifier keys before you select the character key: If
  801. you do it the other way round, DisKey might misinterpret your command.
  802. <L-Amiga>-<Space> will switch you to hex edit mode, while <R-Amiga>-<Space>
  803. will put you in ASCI edit mode.
  804.  
  805.  
  806. 4.0 The DisKey preferences file
  807.  
  808. During startup, DisKey tries to read its defaults from the file
  809. DisKey.prefs, which must be located in either ther current or the S:
  810. directory. If you start DisKey from a CLI, you may also give the path and
  811. name of the configuration file to use as an argument.
  812. Each valid entry starts with a keyword which must start in the first row.
  813. The Keyword is followed by an '=', and after that the value.
  814. The settings marked with an (*) can be changed from the 'DisKey.prefs'
  815. menu.
  816.  
  817.  
  818. 4.1.1 BAMChange = [TRUE|FALSE] (*)
  819.  
  820. If set TRUE, AmigaDOS will be notified of every change in the BAM. Useful
  821. only if you have not inhibited the device you're working on.
  822. In this case, it keeps DOS from writing over sectors which you've just
  823. allocated.
  824.  
  825.  
  826. 4.1.2 BASE = [0|1] (*)
  827.  
  828. Sets the base of the offsets to be used.
  829.  
  830.  
  831. 4.1.3 COLOR<n> = <RGB>
  832.  
  833. Lets you define your custom colors for DisKey. n is in the range of 0 to 3.
  834. The rgb value is a three digit hex number. To set the background color to
  835. black, use the DisKey.prefs entry "COLOR0=000".
  836.  
  837.  
  838. 4.1.4 CURSORDELAY = <n>
  839.  
  840. Sets the delay in n/50 th seconds, before the currently pressed key is
  841. repeated. May be in the range of 0 to 99, while none of the extreme values
  842. makes any sense.
  843.  
  844.  
  845. 4.1.5 CURSORSPEED = <n>
  846.  
  847. Waits n/50th of a second between cursor movements.
  848.  
  849.  
  850. 4.1.6 DC.W = [TRUE|FALSE]
  851.  
  852. Sets the disassembler display mode to use the dc.w notation for
  853. undecodeable data.
  854.  
  855.  
  856. 4.1.7 DRIVE = [<n>|<DeviceName:>]
  857.  
  858. Selects the device which should be used during startup.
  859.  
  860.  
  861. 4.1.8 EDMODE = [ASCII|HEX]
  862.  
  863. Sets the editor mode in which DisKey is set after startup.
  864.  
  865.  
  866. 4.1.9 ICONX= <n>
  867.  
  868. Sets the X position of DisKey's Iconify Icon.
  869.  
  870.  
  871. 4.1.10 ICONY= <n>
  872.  
  873. Sets the Y position of DisKey's Iconify Icon.
  874.  
  875.  
  876. 4.1.11 INHIBIT = [TRUE|FALSE] (*)
  877.  
  878. If true, DisKey inhibits the drive it is currently working on. This
  879. prevents DOS from stumbling over your feet. As long as a drive is
  880. inhibited, you cannot write from another task to it. Useful if you want to
  881. resurrect a disk that has been damaged so badly, that it crashes the
  882. machine whenever you insert it.
  883.  
  884.  
  885. 4.1.12 KEY<n> = <String>
  886.  
  887. Lets you define a new set of hotkeys for the menu n. You have to define all
  888. hotkeys of a certain menue in one go. You do this by entering a two
  889. character combination for each hotkey, starting with the definition of the
  890. first entry in the menu. The first character is either 'R', 'L' or 'C' and
  891. denotes whether you should press the Right or the Left Amiga key, or even
  892. CTRL-Left-Amiga Key as qualifier to execute the hotkey. The second
  893. character is the hotkey that should be used. Please remember that the
  894. second character is case-sensitive!
  895.  
  896.  
  897. 4.1.13 SAFETYCATCH = [TRUE|FALSE] (*)
  898.  
  899. This toggles the safety catch. Leave it on for your own good.
  900.  
  901.  
  902. 4.1.14 LACE = [TRUE|FALSE]
  903.  
  904. Switches the Interlace mode, as required with NTSC machines.
  905.  
  906.  
  907. 4.1.15 LANGUAGE = [DEUTSCH|ENGLISH]
  908.  
  909. Selects the default language.
  910.  
  911.  
  912. 4.1.16 OFFSET = [HEX|DEC]
  913.  
  914. Selects the mode in which offsets are displayed within the disassembler.
  915.  
  916.  
  917. 4.1.17 PRINTFILE = <Filename># (*)
  918.  
  919. Defines a device or file to which all printer output is sent.
  920.  
  921.  
  922. 4.1.18 PRINTINFO = [TRUE|FALSE] (*)
  923.  
  924. Decides wheter you want a header to go with your printout.
  925.  
  926.  
  927. 4.1.19 RAWREAD = [TRUE|FALSE] (*)
  928.  
  929. Enables the use of RAWREAD for checking the bootblock, or reading defective
  930. tracks. Leave this false if you know that Rawread doesn't work with your
  931. setup.
  932.  
  933.  
  934. 4.1.20 REQUESTER = [TRUE|FALSE]
  935.  
  936. Enables the use of the requester for user interaction. To use this feature,
  937. you'll have to install Bruce Dawson's Req.library.
  938.  
  939.  
  940. 4.1.21 RETTEN = <Pfadname># (*)
  941.  
  942. Defines the current path to be used for the capture files.
  943.  
  944.  
  945. 4.1.22 SCREEN = [Workbench|Custom]
  946.  
  947. Defines the screen on which DisKey is opened. Running DisKey on the
  948. workbenh conservers memory, but also covers up the complete workbench. On
  949. a NTSC machine, you might not be able to run DisKey in WB mode, if your
  950. workbench isn't in interlace mode.
  951.  
  952.  
  953. 4.1.23 SETPREFS = [TRUE|FALSE] 
  954.  
  955. Fixes an incompatibility to MachII: If you're using MachII, make sure that
  956. SetPrefs=False.
  957.  
  958.  
  959. 4.1.24 SHOWNULL = [TRUE|FALSE] (*)
  960.  
  961. When true, DisKey checks after each diskchange for known viri.
  962.  
  963.  
  964. 4.2 The defaults
  965.  
  966. BAMCHANGE = TRUE
  967. BASE = 1
  968. COLOR0 = 339
  969. COLOR1 = 0FF
  970. COLOR2 = 000
  971. COLOR3 = C71
  972. CURSORDELAY = 15
  973. CURSORSPEED = 2
  974. DC.W=TRUE
  975. DRIVE = 0
  976. EDMODE = ASCII
  977. ICONX=50
  978. ICONY=50
  979. INHIBIT = FALSE
  980. KEY1=RlRwRdLaLzLyLxLrLYLXRIRiRe
  981. KEY2=CsCrCbCaCfCvClChCpCe
  982. KEY3=RmRhRsRSRfRrLwLFLfLiLpLjLu
  983. KEY4=R0R1R2R3R4R5R6R7R8R9L0L1L2L3L4L5L6L7L8L9
  984. KINDERSICHERUNG = TRUE
  985. LACE = FALSE
  986. PRINTINFO = TRUE
  987. PRINTFILE = PRT:#
  988. RAWREAD = FALSE
  989. RETTEN = RAM:#
  990. SCREEN = CUSTOM
  991. SETPREFS = TRUE
  992. SHOWNULL = TRUE
  993.  
  994.  
  995. 5.0 Greetings / Thanks / Kudos
  996.  
  997. - A sincere 'thank you Ma'm' to Angela, who just gives her best to keep her
  998.   brainchild up to date.
  999.  
  1000. - The author sends a 'Howdy, boys' to all Internet Relay Chatters out
  1001.   there: You all know this is the final frontier of telecommunication,
  1002.   where men are still men, and not only stickers. B^)
  1003.   In particular, the greetings are to those who meet regularly in the
  1004.   Amiga! channel: Top, Stefanb, ZZAcht, Mlelstev, Pythagoras, Franky, and
  1005.   many more. See you there!
  1006.  
  1007. - Many thanks to the guys at Commodore-Amiga: You've really made it
  1008.   worthwile!
  1009.  
  1010. - 'Bill' Hawes: ARexx and WShell are just great! Keep it up!
  1011.  
  1012. - With love to my girlfriend Jutta, who did part of the proof reading, and
  1013.   who sustained me in the hours of need.
  1014.